/*
 * Copyright (c) 2025 EasyAdmin
 * All rights reserved.
 *
 * This file is part of the [EasAdmin] project.
 * Unauthorized copying of this file, via any medium, is strictly prohibited.
 * Proprietary and confidential.
 *
 * Author: EasyAdmin ( 1073602@qq.com )
 * Website: https://www.xhxiao.com
 */
package com.easy.module.system.service;

import com.easy.framework.common.model.TreeModel;
import com.easy.framework.database.service.IService;
import com.easy.module.system.entity.SysMenu;
import com.easy.module.system.query.SysMenuQuery;
import com.easy.module.system.vo.RouterVO;

import java.util.List;
import java.util.Set;

/**
 * 菜单权限表 Service接口
 *
 * @author EasyAdmin ( 1073602@qq.com )
 * @date 2025-08-19
 */
public interface ISysMenuService extends IService<SysMenu,SysMenuQuery>
{
    /**
     * 新增菜单权限
     *
     * @param dto 菜单权限
     * @return 结果
     */
     boolean add(SysMenu dto);

    /**
     * 修改菜单权限
     *
     * @param dto 菜单权限
     * @return 结果
     */
     boolean update(SysMenu dto);

    /**
     * 删除菜单权限信息
     *
     * @param menuId 菜单权限主键
     * @return 结果
     */
    boolean deleteById(Long menuId);


    /**
     * 获取用户权限
     *
     * @param userId  用户ID
     * @param roleIds 角色编号列表
     * @return 菜单权限信息
     */
    Set<String> getUserAuthorities(Long userId, List<Long> roleIds);

    /**
     * 获取用户菜单列表
     *
     * @param query  查询对象
     * @param userId  用户ID
     * @return 菜单列表
     */
    List<SysMenu> getUserMenuList(SysMenuQuery query, Long userId);

    /**
     * 获取用户树形菜单
     *
     * @param userId  用户ID
     * @return 树形菜单
     */
    List<SysMenu> getUserMenuTree(Long userId);

    /**
     * 获取构建路由
     * @return
     */
    List<RouterVO> getRouters(Long userId);

    /**
     * 获取构建路由
     * @param menus
     * @return
     */
    List<RouterVO> getRouters(List<SysMenu> menus);

    /**
     * 获取指定用户的菜单列表
     * @param sysMenuQuery
     * @param userId
     * @return
     */
    List<SysMenu> listByUserId(SysMenuQuery sysMenuQuery,Long userId);

    /**
     * 是否存在菜单子节点
     *
     * @param menuId 菜单ID
     * @return 结果 true 存在 false 不存在
     */
    boolean hasChildByMenuId(Long menuId);

    /**
     * 查询菜单是否存在角色
     *
     * @param menuId 菜单ID
     * @return 结果 true 存在 false 不存在
     */
    boolean hasRoleByMenuId(Long menuId);

    /**
     * 根据用户查询系统菜单列表
     *
     * @param query 菜单信息
     * @param userId 用户ID
     * @return 菜单列表
     */
    List<SysMenu> children(SysMenuQuery query, Long userId);

    /**
     * 获取部门树列表
     * @param list
     * @return
     */
    List<TreeModel> treeList(List<SysMenu> list);


    /**
     * 获取指定角色的菜单ID列表
     * @param roleId
     * @return
     */
    List<Long> getMenuIdListByRoleId(Long roleId);

}
